home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / loc310.zip / LOCATE.DOC next >
Text File  |  1992-12-09  |  11KB  |  225 lines
  1.                             File LOCATE
  2.  
  3.        LOCATE.EXE and LOCATE.DOC are Copyright (C) 1989-1992 of
  4.        Daniel L. Talley, Sr. and Talley & Associates.  All Rights
  5.        Reserved.
  6.  
  7.        To print this form: Have your printer ready, at the DOS prompt
  8.        type COPY LOCATE.DOC LPT1:
  9.  
  10.        Thank you for trying LOCATE!  This program was written in C
  11.        and is of tremendous value when you need to locate files
  12.        across several logical or physical drives.  This program
  13.        (LOCATE.EXE) is NOT public domain.  It is being distributed on
  14.        a Shareware basis.  Simply put,  if you use it then pay for
  15.        it!  Registration information is listed later in this document
  16.        and on the help screen when executed without any parameters.
  17.  
  18.        Unlike similar file locators available, this program does NOT
  19.        require the user to specify a list of drives to search.  The
  20.        program determines what drives are available then proceeds to
  21.        search through all subdirectories on all drives to locate the
  22.        file(s) you specified.  The program will also run in a "Quiet"
  23.        mode in which the full path and file found are displayed.  The
  24.        Quiet mode is useful where a text file is being created to
  25.        save the results of the search.
  26.  
  27. 1)  HOW TO REGISTER LOCATE.EXE
  28.  
  29.        Unless this is an upgrade, the registration form for LO-
  30.        CATE.EXE is located at the end of this document.  Please
  31.        complete the registration form and mail it to the address on
  32.        the form.  Your registration assures you of information about
  33.        upgrades and new products, and newsletters about new develop-
  34.        ments.  
  35.        The registration allows you unlimited upgrades via Modem on
  36.        various BBS's throughout the U.S. ( especially the Power
  37.        Station BBS in Benicia, California (707-552-0462) - and - The
  38.        Dark Side of The Moon in Vacaville, California (707-451-3323); 
  39.        both are great BBS's and worth the optional registration fee). 
  40.        If you desire mailed upgrades follow the instructions on the
  41.        registration form.  If you redistribute, give, or otherwise
  42.        transfer this program to another - You MUST include all of the
  43.        enclosed files as specified in the instructions below.  
  44.  
  45.        Under no circumstances my you charge a fee for this program
  46.        other than a minimal duplication charge.  The files must be in
  47.        their original self-extracting format without any other
  48.        advertisements or modifications AND you must have prior
  49.        written authorization from the author detailing all services
  50.        and fees that will be imposed. (We all want the Shareware
  51.        concept to work for the consumer as well as the author.)
  52.  
  53.       If you purchased the diskette on which this program was
  54.        distributed from any source other than the author,  as listed
  55.        on the registration,  form then you have only paid a duplica-
  56.        tion fee and not for the use of this program. (You must still
  57.        register it with the author.)  Registration will include other
  58.        utilities by return mail that are the copyright works of the
  59.        author along with the latest version of LOCATE.
  60.  
  61.  
  62. 2) COMPATIBLE HARDWARE & SOFTWARE
  63.  
  64.        This program is designed to be compatible with any PC or
  65.        compatible hardware provided it is operated under DOS 3.3x or
  66.        later.
  67.  
  68.  
  69. 3) INSTRUCTIONS FOR USING LOCATE.EXE
  70.  
  71.        Online help is always available by typing LOCATE then tapping
  72.        the return key.  To locate a file simply enter LOCATE file-
  73.        name.ext at the DOS prompt then tap the <Return> or <Enter>
  74.        key.  Wildcard characters are accepted.  The program will
  75.        search all available hard drives and list the filename, size,
  76.        date, time and full path of the file which matches your
  77.        request. Below are the files contained in the LOCATE package:
  78.  
  79.                   LOCATE.EXE, LOCATE.DOC, LOCATE.REG
  80.  
  81.        All but the LOCATE.EXE are standard ASCII text files, and may
  82.        be typed to the screen or redirected to your print device. 
  83.        All options specified below may be used together after the
  84.        option specifier '/' (ie.. locate /qc *.bak) with the excep-
  85.        tion of the '/x' Exclude option.
  86.  
  87.    a) QUIET MODE ( /q )
  88.  
  89.        LOCATE will operate in, what is called, a Quiet mode which
  90.        suppresses all welcome screens and lists only the full file
  91.        path and name.  This is useful when used to create a ASCII
  92.        file containing the full path and filenames located.  To
  93.        instruct LOCATE to operate in the Quiet mode place a '/Q' or
  94.        '/q' before the file specified in the search.  An example
  95.        would be: C:\>locate /q locat*.*
  96.  
  97.        If you want to save the LOCATE results to an ASCII file simply
  98.        put a valid filename an the end of the command ( LOCATE /qc
  99.        *.bak bakfiles.txt ).  If a file exists by that name,  it will
  100.        be overwritten!
  101.    b) LOG-TO MODE ( /l )
  102.  
  103.        LOCATE will allow you to log immediately to the location of an
  104.        occurrence of the found file.  To activate LOG-TO MODE simply
  105.        place the option '/L' or '/l' on the command line with or
  106.        without other available options.  Example: C:\>LOCATE /L
  107.        LOCAT*.*  .  You will be asked if this iswhere you want to
  108.        LOG-TO, tapping the 'Y' key will immediately log you to that
  109.        drive & subdirectory, tapping any other key will continue the
  110.        locate function.  LOG-TO will NOT function in the QUIET mode!
  111.  
  112.    c) DRIVE INFORMATION MODE ( /i )
  113.  
  114.        The Information Mode is specified by option '/I' or '/i'
  115.        before the filename or alone: LOCATE /i or LOCATE /i *.ANY. 
  116.        The second method illustrated will NOT perform a search (the
  117.        filespec is ignored).  It will simply search for all available
  118.        drives and display the amount of available space (in bytes) on
  119.        your drives along with the total drive(s) capacity.  The Quiet
  120.        Mode is disabled when in the Information Mode.
  121.  
  122.    d) CURRENT DRIVE MODE ( /c )
  123.  
  124.        Specifying the '/C' or '/c' option will cause LOCATE to search
  125.        the current logged drive ONLY.  This mode is disabled when the
  126.        Information mode is requested.
  127.  
  128.    e) EXCLUDE DRIVE MODE ( /xCE )
  129.  
  130.        If you want to eliminate specific drives from the search you
  131.        must specify the '/X' or '/x' option.  To use this option you
  132.        must follow it immediately with the drive designators (ie.. c
  133.        d e f ...) without the colon.  For example, to exclude drives
  134.        D and F from the searched drives insert the option as '/xDF'
  135.        or '/Xdf' (upper and lower case letters are acceptable).  You
  136.        may NOT specify any other option adjoining the Exclude option. 
  137.        '/xcq' would NOT give you the Quiet mode while excluding drive
  138.        C,  to do that you would specify '/xc /q' on the command line.
  139.        This option was a result of user requests in instances where
  140.        a removable hard disk is in the drive chain (C...Z).
  141.  
  142.    f) PAUSING AND ABORTING (Keyboard active commands)
  143.  
  144.        You may pause the display at any time by tapping the space
  145.        bar.  You may then continue the display by tapping the space
  146.        bar again.  If you find that you want to ABORT the search
  147.        procedure completely simply tap the ESC (Escape) key.
  148.  
  149. 4) OUR UPGRADE POLICY
  150.  
  151.        Your registration allows you to use future releases of
  152.        shareware version of LOCATE on a lifetime bases.  Updates will
  153.        be posted to BBS's across the U.S. and made available for
  154.        download.  You may write or call Talley & Associates and the
  155.        latest version will be shipped to you by mail for a nominal
  156.        shipping charge.  Consult the registration form for lifetime
  157.        updates by mail.  This program may be redistributed (to your
  158.        friends and associates) provided it is in its complete form
  159.        (ALL DISTRIBUTED FILES AS LISTED IN THE INSTRUCTIONS SECTION)!
  160.  
  161. 5) DISCLAIMER
  162.  
  163.        Although every effort has been taken to insure the proper
  164.        operation of this program,  we accept no responsibility for
  165.        it's use/misuse or it's affect on your hardware and/or data.
  166.        Nor is the author or Talley & Associates responsible for any
  167.        lost time and/or expenses directly or indirectly due to the
  168.        use of this or any associated program.  As with all programs
  169.        used for the first time, test it only after making proper
  170.        backups!  The program should not effect your data.
  171.  
  172.        If you would like to leave comments or suggestions on the
  173.        program, you may do so by calling the number on the registra-
  174.        tion form, leaving a message to Dan Talley on the Power
  175.        Station BBS, or leave a message on CompuServ to user
  176.        70731,1575 or Daniel L. Talley.  Every effort will be made to
  177.        address your suggestions.
  178.  
  179. NOTE:       We have become aware of useful programs being infected 
  180.             with a computer virus then being moved from machine to
  181.             machine every time the program is redistributed.  We, 
  182.             therefore, have incorporated a virus detection scheme
  183.             within LOCATE!
  184.  
  185. 6) OTHER UTILITIES
  186.  
  187.        We proudly offer the following utilities,  currently on a
  188.        shareware basis:
  189.  
  190.             FREMOVE - A file search and deletion program that spans
  191.                       multiple hard drives and deletes all specified
  192.                       files.
  193.  
  194.             NEWFILES- A utility for tape backup subsystems.  Short-
  195.                       ens the length of time required when using
  196.                       some versions of tape backup software.
  197.  
  198.             WHISTLE - Replaces that annoying BEEP in batch file used
  199.                       to get the operators attention.                              REGISTRATION FORM
  200.  
  201.  
  202. Yes, I use your program LOCATE.EXE on a regular basis and wish to register my
  203. copy of the program.  Enclosed please find my registration fee for
  204. LOCATE.EXE.  I understand that I'll receive the latest version of LOCATE and
  205. other utilities, for trial, that you have written.
  206.  
  207.  
  208.  
  209. NAME:______________________________  ___ Copies @ $15.00 ea........._______
  210.  
  211. ADDRESS:___________________________  ___ Lifetime Mail at $25.00 ea._______
  212.  
  213. CITY:______________ ST___ ZIP____________                  SubTotal:_______
  214.  
  215.                 California Residents add 7.25% California Sales Tax:_______
  216.  
  217.                                                              Total:________
  218.  
  219. Please send this form and remittance to:
  220.      Talley & Associates
  221.      Attn: Dan Talley
  222.      137 Fallen Leaf Drive                         Enter Version#__________
  223.      Vacaville, CA  95687
  224.      -----------------------
  225.      Voice: 707 451-4071